home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / utility / base64_5.zip / SHELL64.TXT < prev    next >
Text File  |  1996-08-14  |  9KB  |  199 lines
  1. Documentation for SHELL64.EXE (Base64 Windows shell)
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. CONTENTS:
  5. ~~~~~~~~~
  6. 1. Requirements, Installation Help
  7. 2. About SHELL64
  8. 3. About Encoding
  9. 4. About Decoding (IMPORTANT!)
  10. 5. Distribution, disclaimer, about the author, registration, etc.
  11. 6. Revision notes
  12.  
  13. For more information, view BASE64.TXT.
  14. Please register!
  15.  
  16.  
  17. 1. Requirements, Installation Help
  18. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19. Unlike ENCODE64.EXE and DECODE64.EXE, this program does require Windows.
  20.  
  21. When you first run it, it may tell you that it needs a file called
  22. VBRUN100.DLL. This is an annoying file needed to run many Visual Basic
  23. programs. If you ever track down a copy of it, it needs to be put
  24. into the Windows directory, along with the several thousand other DLL
  25. files you probably have floating around in there.
  26.  
  27. IMPORTANT: This program requires that all the executable files and
  28. all PIFs are extracted into the same directory that SHELL64.EXE is
  29. run from. In other words, the following files need to be in the same
  30. directory for SHELL64 to work: 
  31.  
  32. ENCODE64.EXE -- DECODE64.EXE -- SHELL64.EXE   > Executables
  33. ENCODE64.PIF -- DECODE64.PIF                  > Windows PIF files
  34.  
  35. SHELL64 was written for Windows 3.1 using Visual Basic 1.00, but it may (I  
  36. don't know) run under Windows '95.
  37.  
  38.  
  39. 2. About SHELL64
  40. ~~~~~~~~~~~~~~~~
  41. It has almost no more features than the DOS programs, but it does add 
  42. ease of use to encoding and decoding Base64 files. (For information on 
  43. Base64, look at BASE64.TXT.) This is especially handy if you are using
  44. a Windows-based Internet e-mail program.
  45.  
  46. An item that it does have that the DOS program doesn't is that it allows
  47. input for multiple-part files in Lines, Kilobytes (kb), or Bytes. It
  48. converts these values to Kilobytes (the only type that the DOS program 
  49. uses).
  50.  
  51. This program is called a Shell because it doesn't actually do any 
  52. processing itself, but is only there for running the DOS programs. The
  53. good thing about that is that Windows is sometimes terribly slow, while
  54. the DOS programs are extremely fast.
  55.  
  56. About running File Manager and Viewing a text file: These two buttons
  57. (on the main menu) attempt to run WINFILE.EXE in the default Windows
  58. directory, and NOTEPAD.EXE (also in the default Windows directory).
  59. If it doesn't find them or has an error running them, it will display
  60. an error message. When Viewing a text file is clicked on, it will not 
  61. only run NOTEPAD.EXE, but it will also attempt to pop up its Open 
  62. window, so a text file can be loaded immediately.
  63.  
  64. Another good thing about Shell64 -- even if it does slow down processing,
  65. files CAN be encoded and decoded in the background while you are doing
  66. other things.
  67.  
  68. One final thing: Shell64 converts lines and bytes to kilobytes before
  69. running ENCODE64. There may appear to be some mistakes in its math,
  70. so for best results, use kilobytes instead of lines or bytes.
  71.  
  72.  
  73. 3. About Encoding
  74. ~~~~~~~~~~~~~~~~~
  75. There isn't much to remember about encoding, except that you always
  76. have to remember to specify at least the output drive and directory (where
  77. the files go after they are processed). If you don't, you may have a 
  78. little trouble tracking down those files.
  79.  
  80.  
  81. 4. About Decoding
  82. ~~~~~~~~~~~~~~~~~
  83. If you seem to be getting some strange errors trying to decode files,
  84. then realize that you have a UNIX e-mail system, then you need to
  85. run them through the utility I included with these programs called
  86. (guess?) "UNIX2DOS.EXE". It will convert standard UNIX text files to
  87. the DOS CR/LF standard. Now for the important stuff:
  88.  
  89. Single file decoding: Just select the file to decode in the list box
  90. on the left, the output drive/directory in the boxes on the right, change
  91. the default output file name if you want, and then start decoding.
  92.  
  93. Multipart decoding:     (IMPORTANT!!!)
  94.  
  95. On the decoding screen, you may notice that you can't select any files
  96. in the file list box on the left side of the screen when Multipart
  97. is selected. This is because the list box, when Multipart is selected,
  98. is only there for one thing; to make sure the files to decode are:
  99.  
  100. 1) On the disk
  101. 2) In the correct order
  102.  
  103. When you select Multipart, the program will pop the cursor into the
  104. little text box that previously had the greyed out word "Mask" in it.
  105. This is where you need to type in a generic filename mask to make 
  106. sure the DOS program reads the files in the correct order. This
  107. is a little tricky! Whenever you type in any letters into the Mask
  108. box, the file list on the left will automatically update itself. It
  109. is likely that when you type in the first letter, the list will
  110. be completely blank until you finish writing out the complete Mask.
  111. The trick is to get the right mask so that:
  112.  
  113. 1) The files are in the correct order. 
  114.    (There should be numbers on the end of the filename to help.)
  115.  
  116. 2) There are NO other files in the file list box besides the files that
  117.    need to be decoded.
  118.  
  119. Here's an example to help: Say you just received 5 files over the Internet
  120. which are obviously Base64 encoded. You copy them into a directory called
  121. "C:\STUFF" and name them "PROG01.64", "PROG02.64", "PROG03.64", "PROG04.64"
  122. and "PROG05.64". A sample mask for this would be "PROG*.*". But say
  123. you already have another file in the same directory called "PROGRAM.EXE",
  124. and you definitely do NOT want that to show up on the file list. Then you'd
  125. have to narrow down the mask to something like "PROG*.64". The file
  126. list would update showing the five files in the correct order, there
  127. will be NO other files in the list besides those files, and it is okay
  128. to start decoding once you select a few more options on that screen.
  129. (Such as where to stick the output file when it is being decoded.)
  130.  
  131.  
  132. 5. Distribution, disclaimer, about the author, registration, etc.
  133. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  134. If you enjoy using this program or use it a lot, please write me
  135. for registration information. (See BASE64.TXT for more information.)
  136.  
  137. I'm not responsible if this program does any harm, but if you use it
  138. properly, it shouldn't.
  139.  
  140. These programs can be distributed freely on CD-ROMs, FTP sites, HTTP
  141. sites, BBSs, etc. ONLY if all the files are sent along in the same
  142. archive, intact, un-editted, and not split up to make their ways through 
  143. the world alone. (See VENDOR.TXT)
  144.  
  145. This program was written by Fire Frog (not my real name :).
  146.  
  147. I enjoy being e-mailed by people who have any suggestions for updates,
  148. bug reports, want to thank me for these wonderful programs, or are having
  149. pangs of guilt from using it for so long without writing (or sending
  150. money :).
  151.  
  152. Some have already written me about my DOS programs, and because of that,
  153. they are the sleek, fast, well-programmed things they are today.
  154.  
  155. My Internet e-mail address: frog@star2.opsys.com
  156.  
  157. I can be contacted on this BBS based in the Miami, Florida area, and
  158. the latest versions are always available for downloading here sooner
  159. than anywhere else:
  160.  
  161. MANx CAT BBS
  162. (305) 245-0113
  163. Sysop: Major Airwaves
  164.  
  165. World Wide Web address:
  166.  
  167. http://www.gil.net/~airwaves
  168.  
  169.  
  170. 6. Revision Notes
  171. ~~~~~~~~~~~~~~~~~
  172.   Below is inscribed the notes for any revisions that may have been 
  173. added to Shell64. To see all the neat things I've added to the DOS
  174. programs, look in this section in BASE64.TXT.
  175.  
  176.   Note that version #1 was distributed along with version #4 of my
  177. DOS programs, and that the archive these programs come in is named 
  178. after the current version of the DOS programs, NOT the Windows shell 
  179. program (which came later).
  180.  
  181. --\
  182. #1|--> Basic version. Probably crawling with bugs.
  183. --/     (Sent around in archive of version #4 of the DOS programs.)
  184.  
  185. --\
  186. #2|--> 1. When multi-part encoding with Lines or Bytes (as the basis 
  187. --/        for the outputted files' size), Shell64 will hit nearer to 
  188.            the size mark in the files that are outputted. (Everything 
  189.            needs to be computed to the nearest kilobyte, but it wasn't 
  190.            very accurate before the change.)
  191.  
  192.        2. Shell64 won't allow two instances